home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 (Alt) / MACD 5.bin / workbench / docs / datatypes_library.doc1 < prev    next >
Encoding:
Text File  |  1997-03-29  |  6.9 KB  |  173 lines

  1.  
  2.  
  3. /*
  4. **
  5. **  $VER: datatypes_library.doc 45.2 (30.3.97)
  6. **  datatypes_library V45
  7. **
  8. **  documentation
  9. **
  10. **  Original V41 written (c) 1994/1995 by Christian Buchner
  11. **  V45 written by Roland 'Gizzy' Mainz since 1996/1997
  12. **  Based on David Junods work
  13. **
  14. */
  15.  
  16. ==================  datatypes.library V45 documentation   =================
  17. ===========================================================================
  18. This is the second public release of the datatypes.library V45.
  19. This release is mainly to get an overview about the project; some
  20. parts of the distribution aren't finished yet (the library itself
  21. is ready).
  22.  
  23. As you can see, the documentation isn't finished yet...
  24.  
  25. The library should be backwards compatible to V40.6 (OS 3.1 release)
  26. and contains many extensions to it.
  27.  
  28. Currently, only the autodoc in Docs/ describes the changes.
  29.  
  30. ========================= Distribution Roadmap ============================
  31. ===========================================================================
  32.  
  33. Development/#?                           - Development related stuff
  34. Development/clib/datatypes_protos.h      - C prototypes
  35. Development/datatypes/datatypes.pch      - SAS/C patch file to create "datatypes.h" using the CBM version
  36. Development/datatypes/datatypesclass.pch - SAS/C patch file to create "datatypesclass.h" using the CBM version
  37. Development/fd/datatypes_lib.fd          - FD file
  38. Development/pragmas/datatypes_pragmas.h  - SAS/C pragmas
  39. Development/proto/datatypes_protos.h     - C prototypes (for dice etc.)
  40. Libs/datatypes.library                   - The shared library itself
  41. Docs/datatypes_library.doc               - This document
  42. Docs/datatypes.library.doc               - Autodocs
  43. Examples/clonemethods/#?                 - CloneMethods example
  44. Examples/dtdescrlist/#?                  - Example how to read the global descriptor list
  45. Examples/dtimage/#?                      - Example how to use datatype as an imageclass object
  46. Examples/dodt/#?                         - Small tool browser, usefull in macros etc.
  47. Examples/dtrequester/#?                  - Example of a datatypes brower, dealing with new features
  48. C/AddDataTypes                           - The new adddatatypes; try AddDataTypes EDIt from Shell to edit tool nodes
  49. C/GMultiView                             - MultiView replacement
  50. C/spatch                                 - SAS/C spatch tool to convert CBM includes + #?.pch files -> GIS includes
  51.  
  52. ====================== Request for comments/help ==========================
  53. ===========================================================================
  54. I need all help I can get.
  55.  
  56. Maybe, I can call this release (V45.2) Insect-Ware :-) : All users have to
  57. report any insects (bugs for example) which occurs in conjunction with this
  58. software.
  59. Except this special term, this software is FREEWARE.
  60.  
  61. ============================== Tools  =====================================
  62. ===========================================================================
  63.  
  64. I've included tree tools in this distribution:
  65.  
  66. C/AddDataTypes    - V45.1 which supports tool nodes
  67. C/GMultiView      - MultiView replacement, prototype version (pre-alpha), 
  68.                     V1.8
  69. C/spatch          - "spatch" utility, SAS Binary File Patcher V6.50
  70.                     Copyright © 1992 SAS Institute, Inc., All Rights Reserved
  71.  
  72. ========================= example source ==================================
  73. ===========================================================================
  74.  
  75. The V45 introduces new includes. To avoid legal problems, they're
  76. shipped as patch files. The "spatch" utility, SAS Binary File Patcher V6.50
  77. Copyright © 1992 SAS Institute, Inc., All Rights Reserved, is
  78. included in the C/ directory.
  79. You must use the V3.1 includes "datatypes/datatypes.h" 
  80. (datatypes.h 39.6 (22.04.93)) and "datatypes/datatypesclass.h"
  81. (datatypesclass.h 39.8 (17.03.93)) to convert the old into the new includes.
  82.  
  83. The directory Examples/ contains different examples which shows the
  84. usage of the new datatypes.library functions:
  85.  
  86. clonemethods   -- Shows method cloning
  87.  
  88. dtasl          -- ASL requester with datatypes filtering
  89.  
  90. dodt           -- Examine file, list tools which support this data type,
  91.                   and launch them on request
  92.  
  93. dtdescrlist    -- Easy access to the global descriptor list.
  94.                   The list can be printed out completely, or only
  95.                   these descriptors will be printed which matched the given
  96.                   file
  97.  
  98. dtconvert      -- converts datatypes into another datatype (if they have the
  99.                   same GID_#? identifier).
  100.  
  101. dtimage        -- Use datatypesclass object (picture etc.) as an image object.
  102.  
  103. dtrequester    -- Shows datatypes object usage as an gadget in a window
  104.                   or requester; on request you can specify the class
  105.                   which should handle the data, e.g. view AmigeGuide as
  106.                   ASCII soure etc.
  107.  
  108. embed_datatype -- Embed one or more datatypes object within another
  109.                   datatypes object
  110.  
  111.  
  112. =========================== Author's Request ==============================
  113. ===========================================================================
  114. By  releasing  this program I do  not  place any obligations on you,
  115. feel free to share this program with your friends (and enemies).
  116. This is FREEWARE (V45.1 and V45.2 are "Insect-Ware", see above).
  117.  
  118. If you want to blame me, report any bugs, or wants a new version
  119. send your letter to:
  120.                 Roland Mainz
  121.                 Hohenstaufenstraße 8
  122.                 52388 Nörvenich
  123.                 GERMANY
  124.  
  125. Phone: (+49)(0)2426/901568
  126.  
  127. EMAIL is also available:
  128. GISBURN@w-specht.rhein-ruhr.de
  129.  
  130. If you want to send me attachments larger than 1MB (up to 5MB, more with my
  131. permission):
  132. Up to March 1997 I'm reachable using this email address, too:
  133. Reinhold.A.Mainz@KBV.DE
  134.  
  135. | Please put your name and address in your mails !
  136. | German mailers should add their phone numbers.
  137. | See BUGS section above when submitting bug reports.
  138.  
  139.  
  140. Sorry, but I can only look once a week for mails.
  141. If you don't hear something from me within three weeks, please send your
  142. mail again (but watch about new releases) (problems with this email port
  143. are caused by reconfigurations, hackers, network problems etc.).
  144.  
  145.  
  146.  
  147. If you want to contact Christian Buchner:
  148.  
  149. Christian Buchner
  150. Steinbergstraße 2
  151. 82110 Germering
  152. Germany
  153. Tel.: (+49)(0)89/849868
  154.  
  155. EMAIL:
  156. flowerp@eikon.e-technik.tu-muenchen.de
  157.  
  158. <flowerp> on irc #amiga and #amigager
  159.  
  160. The  entire  "datatypes.library"  package  may  be  noncommercially
  161. redistributed, provided  that  the package  is always  distributed in it's
  162. complete  form (including it's documentation).  A small copy fee  for media
  163. costs is okay but any kind of commercial distribution is strictly forbidden!
  164. Comments  and  suggestions  how  to  improve  this  program  are generally
  165. appreciated!
  166.  
  167. Thanks to Christian Buchner for his work, David Junod, who wrote the CBM
  168. datatypes.library, Matt Dillon for his DICE, Olaf 'Olsen' Barthel for his help,
  169. ideas and some text clips from his documentations.
  170.  
  171.  
  172.  
  173.